Skip to main content
GET
/
v1
/
mcp-configs
/
{id}
JavaScript
import Runloop from '@runloop/api-client';

const client = new Runloop({
  bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted
});

const mcpConfigView = await client.mcpConfigs.retrieve('id');

console.log(mcpConfigView.id);
{
  "id": "<string>",
  "name": "<string>",
  "endpoint": "<string>",
  "allowed_tools": [
    "<string>"
  ],
  "create_time_ms": 123,
  "account_id": "<string>",
  "description": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The unique identifier of the McpConfig.

Response

Successfully retrieved the McpConfig.

An McpConfig defines a configuration for connecting to an upstream MCP (Model Context Protocol) server. It specifies the target endpoint and which tools are allowed.

​
id
string
required

The unique identifier of the McpConfig.

​
name
string
required

The human-readable name of the McpConfig. Unique per account.

​
endpoint
string
required

The target MCP server endpoint URL (e.g., 'https://mcp.example.com').

​
allowed_tools
string[]
required

Glob patterns specifying which tools are allowed from this MCP server (e.g., ['github.search_', 'github.get_'] or ['*'] for all tools).

​
create_time_ms
integer<int64>
required

Creation time of the McpConfig (Unix timestamp in milliseconds).

​
account_id
string | null

The account ID that owns this config.

​
description
string | null

Optional description for this MCP configuration.